home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / cvt2qb11.zip / CVT2QBBS.DOC < prev    next >
Text File  |  1993-05-01  |  9KB  |  180 lines
  1.  
  2.    ██████╗ ██╗   ██╗ ████████╗ ██████╗   ██████╗  ██████╗  ██████╗  ███████╗
  3.  ██╔════╝ ██║   ██║ ╚══██╔══╝ ╚════██╗ ██╔═══██╗ ██╔══██╗ ██╔══██╗ ██╔════╝
  4.  ██║      ██║   ██║    ██║     █████╔╝ ██║   ██║ ██████╔╝ ██████╔╝ ███████╗
  5.  ██║      ╚██╗ ██╔╝    ██║    ██╔═══╝  ██║▄▄ ██║ ██╔══██╗ ██╔══██╗ ╚════██║
  6.  ╚██████╗  ╚████╔╝     ██║    ███████╗ ╚██████╔╝ ██████╔╝ ██████╔╝ ███████║
  7.   ╚═════╝   ╚═══╝      ╚═╝    ╚══════╝  ╚══▀▀═╝  ╚═════╝  ╚═════╝  ╚══════╝
  8.  
  9.                ╒═════════════════════════════════════════════╕
  10.                │                                             │░░
  11.                │ T H E  T A G  TO  Q B B S  D A T A  F I L E │ ░
  12.                │                                             │ ░
  13.                │     C O N V E R S I O N  U T I L I T Y      │ ░
  14.                │                                             │ ░
  15.                ╘═════════════════════════════════════════════╛ ░
  16.                     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  17.  
  18.  
  19.  
  20.  
  21.  
  22. Acknowledgements
  23. ~~~~~~~~~~~~~~~~
  24.     Thanks got to the TAG team for providing the structure information
  25.     necessary for utility authors to create the utilities that *we* all
  26.     ask for. Thanks especially to Victor Capton and Paul Williams, not only
  27.     for remaining the driving forces behind this special BBS system, but also
  28.     for giving insight  into  TAG's  inner  workings  making this and other
  29.     projects soooooooo much easier to handle.
  30.  
  31.     TAG is copyrighted By The T.A.G. Team
  32.     QuickBbbs (referred to as QBBS) is Copyrighted By Pegasus Software
  33.  
  34.     This program is  copyrighted  by  Rick  Cooper  and  remains  the  sole
  35.     property  of  same.  CVT2QBBS  is  NOT public domain, rather it's to be
  36.     considered freeware.
  37.  
  38. Guarantees/Warranties/And Other Fantasies
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40.     There is no warranty or guarantee offered with this program. The only
  41.     thing I will guarantee is it's ability to take up disk space.
  42.  
  43.     By using this program  you  agree  to  hold  harmless the author in all
  44.     regards and circumstance including but not limited to:
  45.  
  46.         Damage to drives
  47.         Damage to Date
  48.         Loss of income
  49.         Increased Sexual Awareness
  50.         Change of Gender or Species
  51.  
  52.  
  53. Purpose
  54. ~~~~~~~
  55.       Ain't  but  one  purpose  boys  and  girls and that is to allow TAG BBS
  56.     systems to interface easily and  quickly  with QBBS doors and utilities
  57.     that require real  information  rather  than  the  make  believe  stuff
  58.     generated   by   less,   application  specific,  more  generalized  Door
  59.     converters.
  60.  
  61.     CVT2QBBS will create the following Files:
  62.  
  63.         QUICKCFG.DAT    : Main QBBS Configuration File
  64.         MSGCFG  .DAT    : Message Base Configuration File
  65.         FILECFG .DAT    : File Base Configuration File
  66.         LIMITS  .CTL    : Daily Download K By S/L Restriction File
  67.         EVENTCFG.DAT    : Events Configuration File
  68.         USERS   .BBS    : QBBS Users List Data File
  69.         ALIAS   .BBS    : QBBS User Handle/Alias File
  70.         FILES   .BBS    : QBBS File Listing Files
  71.         FB??????.BBS    : QBBS CD-ROM File Listings Files.
  72.         FLSEARCH.CTL    : Old Style File Search List For ALLFIX
  73.  
  74.     These files are written  true  to  QBBS  Version 2.76 standards and will
  75.     interface with virtually any door or utilities designed to operate with
  76.     QBBS  version  2.7?  (previous  QBBS  version  used  entirely  different
  77.     structures).
  78.  
  79. Command Line Switches
  80. ~~~~~~~~~~~~~~~~~~~~~
  81.     The calling syntax is as follows:
  82.  
  83.         CVT2QBBS (TAG System Dir) (TAG HMS Message base) [NOFILES] [V=?]
  84.  
  85.     Where :
  86.             TAG System Dir    := Path to TAG node's STATUS.DAT
  87.             TAG HMS Path    := Path To Hudson Message Base
  88.             NOFILES         := Will Prevent  CVT2QBBS  from  Updating  List
  89.                                Files
  90.             V=              := Validation Key to use for new user validation
  91.                                This will allow you to use QBBS call back
  92.                                Verifiers (in conjunction with TAGUDATE)
  93.                                for user validation
  94.  
  95.     The  NOFILES  (case is not important) switch will prevent CVT2QBBS from
  96.     generating list files if  you  are  running multi-node with shared file
  97.     bases. The NOFILES switch should be used at least  once  so  your  list
  98.     file  system  is  maintained  but  is  redundant  if all file bases are
  99.     shared.
  100.  
  101.     The V= parameter (which can be swapped with the  NOFILES  option)  will
  102.     tell  CVT2QBBS which validation key to use for the call back validation
  103.     portion of the configuration file.  If  you do not specify a validation
  104.     key the CVT2QBBS will use the first validation record. Since TAGUDATE
  105.     will adjust the user AR flags and SL (and phone  number)  if  they  are
  106.     changed  in  a  door, you can now use a call back verifier designed for
  107.     use with QBBS. Two things to remember:  The DSL will be set to the same
  108.     level as SL (they are not seperated in QBBS) and the Special flags will
  109.     be set to what ever options the user has but will NOT be changed  other
  110.     wise  by  TAGUDATE...  Again there are no SPECIAL flags with QBBS. This
  111.     means if you use the mail  not  validated flag with non validated users
  112.     then it will remain after validation and you *will* have to  toggle  it
  113.     off manually.
  114.  
  115. Setup
  116. ~~~~~
  117.     There isn't any per  say.  Just  place  CVT2QBBS in a directory that
  118.     is in your path... Make  sure  you  CALL the program from the directory
  119.     that you wish to use  as  this  particular  QBBS  node  directory  (the
  120.     program  will  write  the  data files to the CURRENT directory). If the
  121.     file SLK.DAT exist (by calling SETDLK  before CVT2QBBS) it will use the
  122.     information within to write the LIMITS.CTL file. (See the SETDLK.DOC
  123.     file for details).
  124.  
  125.  
  126. Operation
  127. ~~~~~~~~~
  128.     CVT2QBBS will maintain all  of  your  security  setups  in  regards  to
  129.     message  bases, file system, logon information, etc.. Both the security
  130.     level and FLAGS are maintained  in  all areas. This means that programs
  131.     that respect the QBBS security system will also respect  yours  without
  132.     modification.  It  will  also maintain all of your message base setups,
  133.     Network  AKAs,  Origin  lines,   private  areas,  ANSI  allowances  and
  134.     restrictions  as  well.  In case you are not familiar with QBBS, by the
  135.     way, USERS.BBS will be  written  in  your  HMS directory. This is means
  136.     that you will have a  different  USERS.BBS  for  each  separate  hudson
  137.     message  base  that  you  operate.  (multiple  nodes  with a single HMS
  138.     base will share the USERS.BBS user list)
  139.  
  140.     Used in conjunction with the rest of  the  utilities  included  in  this
  141.     archive  you  can  rest  assured that interfacing to your favorite QBBS
  142.     doors and maintenance program  will  be  smooth and efficient. Some of
  143.     the programs you will be able to run are:
  144.  
  145.         Blue Wave        : Proprietary Offline Mail Door
  146.         GrayQwk            : The best QWK Offline Mail Door for any BBS type
  147.         AcFiles            : The best file download/upload/maintenance system
  148.  
  149.     About the  only  TAG  specific  setup  that  CVT2QBBS  cannot handle is
  150.     multiple hudson message bases. If you want  to  use  the  program  with
  151.     messaging system such as GrayQwk you will have to setup a directory for
  152.     each  node and each message base you wish to access. This is cumbersome
  153.     but unless QBBS and it's related utility authors decided to embrace the
  154.     multiple hudson message base  idea  TAG  will  continue  to be the only
  155.     system using  this  concept.  To  expand  your  ability  to  use  these
  156.     utilities  and  programs, I would recommend using only a single message
  157.     base unless you have over 200 areas or 16mg of message base.
  158.  
  159.     If you plan to run several QBBS utilities or Doors  I  would  recommend
  160.     setting  up  a  permanent QBBS node directory for each of your TAG node
  161.     directories and simply point each  given door/utility to the proper QBBS
  162.     node directory... There is no need to maintain a separate  QBBS  system
  163.     for  each program. This will reduce the maintenance time and disk space
  164.     usage. This would also mean you  will not need other EXITINFO/QBBS data
  165.     file  creation  utilities  (such  as  DoorMaster)...  to   create   the
  166.     DorInfo?.Def,   ExitInfo,   and   UserOn   Drop  files  just  call  the
  167.     EXITINFO.EXE program  and  point  to  the  correct  QBBS  and  TAG node
  168.     directories. (See the EXITINFO.DOCs for details)
  169.  
  170.  
  171. If there is a problem
  172. ~~~~~~~~~~~~~~~~~~~~~
  173.  
  174.     I can be contacted via the TAGBETA, TAG, TAGDOORS echos or you can call
  175.     my BBS (Just For The Heck Of  It  II) at (219) 747-5971.. Or netmail me
  176.     at 1:236/16 @FidoNet
  177.  
  178.     Rick Cooper
  179.  
  180.